.TH gnap_remaster 1 "May 2005" "GNAP"
.SH NAME
gnap_remaster \- Extend a GNAP core with extensions
.SH SYNOPSIS
.B gnap_remaster
-e extension [ options ]
.SH DESCRIPTION
.B gnap_remaster
will create new GNAP core by extending the basic core with specified
extensions. It will start from a GNAP core file and base filesystem, then add
the specified extensions and produce a new core tarball, ready for use with
.B gnap_overlay.
Note that you need to be root to run
.B gnap_remaster.
.SH OPTIONS
.TP
.B "\-e" extension
Use the specified prebuilt extension to customize the GNAP
Core. Those gnapext_*.tbz2
files are located by default in /usr/lib/gnap/extensions. You can 
specify multiple
.B "\-e"
options to enable multiple extensions. Note that you should specify the
extension name ("boa") rather than the extension filename ("gnapext_boa.tbz2").
.TP
.B "\-k" minkernpackage
Replace the kernel used by the one in the specified minkernpackage tbz2 file.
minkernpackages are built using genkernel --minkernpackage option.
.TP
.B "\-m" modulespackage
Replace the modules used in the core by those in the specified modulespackage
tbz2 file. modulespackages are built using genkernel --modulespackage option.
.TP
.B "\-o" outputfile
Name of the core file to use as output. By default it will be called
mygnap-core-version.tar
.TP
.B "\-g" gnap_core
Location of the GNAP core file to use as a base.
By default, it will use the /usr/lib/gnap/gnap-core-XXX.tar file corresponding
to the current version.
.TP
.B "\-b" basefs
Location of the GNAP base filesystem .tar.bz2 file to use as a base.
By default, it will use the /usr/lib/gnap/gnap-basefs-XXX.tar file
corresponding to the current version.
.TP
.B "\-d" extdir
Directory containing the extension files. By default, it will use
/usr/lib/gnap/extensions
.TP
.B "\-f"
Force all answers to yes. Use at your own risk.
.SH EXAMPLES
.B gnap_remaster
-e boa

Create a new GNAP core file based on the current version, adding the boa 
extension in.

.B gnap_remaster
-d myproject/extensions -e myext -o myowncore.tar

Create a new GNAP core file names myowncore.tar, based on the current version,
adding the myext extension from myproject/extensions (the
myproject/extensions/gnapext_myext.tbz2 file).
.SH SEE ALSO
.BR gnap_make (1),
.BR gnap_overlay (1)
.SH AUTHOR
.nf
Thierry Carrez (koon@gentoo.org)
.fi
